FacetAdded

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODPart

FacetAdded
The FacetAdded method is called to notify this part that a facet has been added to one of its display frames.
void FacetAdded (in ODFacet facet);
facet
A reference to a facet that has been added.

DISCUSSION
OpenDoc calls this method when your part's containing part adds a facet to one of your part's display frames. If your part is the root part in a window, OpenDoc calls this method when the window is opened.
Your part's FacetAdded method should perform any actions necessary to handle the addition of the new facet to one of your part's display frames. Some actions depend on the nature and implementation of your part itself, but others are standard. Standard actions include creating facets for all visible embedded frames within the area of the added facet, storing appropriate part info data in the facet, examining the facet's canvas to make sure your part editor understands how to draw on that canvas, and creating an offscreen canvas, if the facet needs one.
If your part does not support asynchronous display and is not a container part, it is not necessary for it to do anything except possibly validate that it can draw to its canvas.

OVERRIDING
When you subclass ODPart, you must override this method. Your override method must not call its inherited method; that is, your override method must implement this method's functionality completely.

SEE ALSO
The ODFrame::FacetAdded method (page 319).
The ODPart::FacetRemoved method (page 515).
"The FacetAdded Method" on page 75 in OpenDoc Cookbook.
Table 2-1 on page 89 in OpenDoc Programmer's Guide.
"Responding to Added or Removed Facets" on page 107 in OpenDoc Programmer's Guide.
"Adding and Removing Canvases" on page 133 in OpenDoc Programmer's Guide.
"Setting Up" on page 157 in OpenDoc Programmer's Guide.
"Null Events" on page 194 in OpenDoc Programmer's Guide.